
TIconGrabber
************

Copyright  1996 Sadman Software.  All Rights Reserved.
100717.3531@compuserve.com

V1.00 9-May-1996


Description
-----------
Simply set the filename property, and TIconGrabber makes available all the icon
from the file.

The demonstration version will not operate unless the Delphi IDE is active.


Published Properties
--------------------
Filename: string
   The name of the .EXE, .DLL, .ICO or .NIL file to have the icons extracted.

LoadOption: TLoadOption = (loLoadAsRequired, loPreLoad)
   Whether all icons should be loaded as soon as the file name is set
   (loPreLoad), or as/if required (loLoadAsRequired).

OnChange: TNotifyEvent
   An event that fires when the filename is changed.

Public Properties (run-time and read only)
-----------------
Icons[index: integer]: TIcon
   The icon(s) from the specified file.  Will raise an exception if the
   index is invalid.  Indices start at 0.

NumberOfIcons: integer
   The number of icons in the specified file.  May be zero.

Exceptions
----------
EInvalidIndex: raised if an attempt is made to access a non-existent icon.


Installation
************
Please refer to your Delphi manual for more information on how to add components
to the VCL.

Unzip the *.DCU and *.DCR files into a directory containing your add-on
components.  Select Options|InstallComponents|Add and select ICONGRAB.DCU.

The components will install to a page called 'Extra' in your component palette.
Choose Options|Project|Palette to move it to a different page.


Demo Program
************
A demonstration program/utility is included in the zip.  This allows the
selection of an icon-containing file and displays the icons it contains.  The
icons may then be extracted to individual .ICO files.


Registering
***********
Registration is currently only available via CompuServe's SWREG.  GO SWREG
and enter one of the following numbers:
11442 for registered version of TIconGrabber, price is $10.
11443 for registered version of TIconGrabber with full source, price is $20.

The registered version will be returned via e-mail.  Registration entitles you
to support via e-mail and free upgrades for any bug fixes for a period of six
calendar months from the registration date.



DISCLAIMER
The author cannot and does not warrant that any functions contained in the
software will meet your requirements, or that its operations will be error free.
The entire risk as to the software performance or quality, or both, is solely
with the user and not the author.  You assume responsibility for the selection
of the component to achieve your intended results, and for the installation,
use, and results obtained from the software.

The author makes no warranty, either implied or expressed, including without
limitation any warranty with respect to this software documented here, its
quality, performance, or fitness for a particular purpose. In no event shall
the author be liable to you for damages, whether direct or indirect, incidental,
special, or consequential arising out the use of or any defect in the software,
even if the author has been advised of the possibility of such damages, or for
any claim by any other party.

All other warranties of any kind, either express or implied, including but not
limited to the implied warranties of merchantability and fitness for a
particular purpose, are expressly excluded.


Delphi is a trademark of Borland International.


